home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 5: The Fifth Dimension / 17 Bit - The Fifth Dimension (1995)(17 Bit Software)[!].iso / files / 3708.dms / 3708.adf / CLI / AddMem.doc / AddMem.doc
Text File  |  1994-12-04  |  8KB  |  161 lines
  1.  
  2.  
  3.                                 AddMem
  4.  
  5.                     Version 3.01 written on 8/29/1994
  6.                           by Martin Schlodder
  7.  
  8.     This is version 3.01 of AddMem, a bugfix for version 3.0.
  9.  
  10. This program only runs with  OS 2.0  or higher.  It behaves like a typical CLI
  11. command through the use of ReadArgs(). If run with OS 2.1 or higher, it prints
  12. all messages in the preferred language if a suitable catalog is installed. The
  13. installation is rather quick:  Just  copy  the program to any directory in the
  14. path of the shell, preferably "SYS:C", and the suitable catalog (in the moment
  15. there is only  a  german  catalog  available,  english texts are built in)  to
  16. "LOCALE:Catalogs/<language>". The documentation will not be really neccessary,
  17. because AddMem has a help text built in.
  18.  
  19. ------------------------------------------------------------------------------
  20.  
  21. AddMem adds expansion memory that  is  not  auto configurating to the system's
  22. memory list.  The required flags for the memory type will be set automatically
  23. as far as possible.  If these  precalculated  flags are not ok,  they might be
  24. changed through the arguments to the program call. The start and end addresses
  25. will be validated (certain areas of the Amiga's memory range are reserved) and
  26. the program will look if there  really  is  RAM at this position  (reset proof
  27. programs and data will not be affected by this).  If required, AddMem can do a
  28. bitwise memory check wich will take some time (about one minute per MByte) and
  29. wich destroys any data in this area. AddMem requires at least OS 2.0 (better
  30. OS 2.1) and of course a non autoconfig memory board.
  31.  
  32.  
  33.  Usage: AddMem startadress endadress [CheckMem] [A1000Fast] [32Bit]
  34.                [LOCAL] [!PUBLIC] [CHIP] [FAST] [!24BITDMA]
  35.                [priority] [RESIDENT]
  36.  
  37.  startaddress, endaddress:
  38.     Start and end addresses of the memory area as hexadecimal numbers. Both of
  39.     them must be a multiple of eight.  The  numbers may begin with a '$'.  The
  40.     endaddress might be either the  last  byte of the memory area or the first
  41.     byte after it (e.g. $200000 to $3fffff or $200000 to $400000).
  42.  CheckMem:
  43.     Memory will be checked before being added to the system's memory list.
  44.  A1000Fast:
  45.     The memory range will become PUBLIC|FAST|LOCAL|24BITDMA with a priority of
  46.     0, if it is located between $200000 and $A00000.
  47.  32Bit:
  48.     The memory range will become  PUBLIC|FAST with a priority of +5 and depen-
  49.     ding on it's position 24BITDMAable (if it is located below $1000000).
  50.  LOCAL:
  51.     This argument should only  be  set,  if the memoy is directly connected to
  52.     the CPU, i.e. not on the Zorro bus.
  53.  !PUBLIC, CHIP, FAST, !24BITDMA:
  54.     Memory attributes to override the precalculated type. Seldom needed.
  55.  priority:
  56.     Priority of the memory area. Defaults to 0.
  57.  RESIDENT:
  58.     An AddMem program will be placed in the boot process  (to be exact, in the
  59.     CoolCapture). It can be removed by pressing the left mouse button for some
  60.     seconds after a reset or  by switching the computer off and on again or by
  61.     doing a reboot wich removes Exec, such as my program Reset does. The Cool-
  62.     Capture program checks for double enrties of the memory range, and in that
  63.     case removes any program that used the  CoolCapture and thus any boot pro-
  64.     gram initialized by AddMem.  You  can  of  course add several memory areas
  65.     with this option set. They will all be added after a Reset with the chosen
  66.     flags.
  67.  
  68.  
  69. In Kickstart 1.3 the following memory flags were defined:
  70.  
  71.  - PUBLIC     Was nearly always  set  and  therefor had no meaning. Today it's
  72.               used by virtual memory managers to determine which memory may be
  73.               swapped. It is always set in the memory list.
  74.  - CHIP       CHIP memory is accessible by  the Amiga's custom chips  (who are
  75.               responsible for graphics, sound, diskdrive etc.).  It was origi-
  76.               located in the lowest  512 KBytes  of  the Amiga's memory range,
  77.               then 1 MByte and now 2 MBytes.
  78.  - FAST       FAST memory is  all  memory  except  CHIP memory.  It is usually
  79.               faster than CHIP memory, as the processor can access it directly
  80.               and is not slowed down by custom chip DMA. The only exception is
  81.               is the Ranger Memory of the Amiga 500 and the Amiga 2000A, which
  82.               is not accessible by the  custom  chip DMA and still slowed down
  83.               by it.
  84.  
  85. In OS 2.0 the following flags were added:
  86.  
  87.  - LOCAL      This is memory, that is direktly accessible by the CPU and which
  88.               is not connected through the Zorro  bus.  This memory will still
  89.               be accessible after a RESET  CPU  instruction while Zorro memory
  90.               might vanish.
  91.  - 24BITDMA   Memory which is located in the address range of the Zorro II bus
  92.               (this is the address range  of  the MC68000, $000000 to $FFFFFF)
  93.               has this flag set.
  94.  
  95. This flag is defined since OS 3.0:
  96.  
  97.  - KICK       Memory which is added  to  the  system's  memory list before the
  98.               KickTags are processed will be of this type.
  99.  
  100.  
  101. AddMem uses all these flags. PUBLIC will always be set if the argument !PUBLIC
  102. was not set.  CHIP is set if the  memory  range is located below $200000 or if
  103. the argument CHIP is given.  If  the memory is located above $200000 or if the
  104. argument FAST was given,  the flag FAST will be set.  The flag 24BITDMA is set
  105. if the memory is located  below  $1000000 and if the argument !24BITDMA is not
  106. given.  According to the Autodocs,  KICK should not be set when adding memory.
  107. But when the memory is added by the RESIDENT CoolCapture program,  it is added
  108. early enough so that KICK can be set.
  109.  
  110. This program was written completely in assembly language (OMA 2.05).
  111.  
  112. ------------------------------------------------------------------------------
  113.  
  114. For questions or suggestions you may reach me:
  115.  
  116. via EMail (internet):
  117.    schlodder@student.uni-tuebingen.de
  118.  
  119. Or write me:
  120.    Martin Schlodder
  121.    Uhlandstr. 18
  122.    D-72336 Balingen
  123.  
  124. ------------------------------------------------------------------------------
  125.  
  126. Copyright:
  127.  
  128. AddMem is FreeWare.  You may use it and copy it,  as long  as you leave it un-
  129. changed.
  130.  
  131. DISCLAIMER:
  132.  
  133. I am not responsible for loss of data,  damage or other problems resulting di-
  134. rectly or indirectly from the use of this program.
  135.  
  136. ------------------------------------------------------------------------------
  137.  
  138. HISTORY:
  139.  
  140. V0.5:   First Version.  Uses the OS2.0 type PUBLIC|FAST|LOCAL|24BITDMA for the
  141.         new memory.
  142. V0.6:   Now checks for the option 'CheckMem' before testing the memory.
  143. V1.0:   Works now with Kick 1.3 and  earlier versions by using the memory type
  144.         PUBLIC|FAST for them.
  145. V2.0:   This version, again, runs only with OS 2.0 and higher, for is uses now
  146.         the new commandline parsing function of DOS.  Any type of memory might
  147.         now be added,  since  any combination of memory flags can be specified
  148.         (except CHIP|FAST).
  149. V2.01:  FPuts replaced by PutStr.
  150. V2.1:   Accepts now the OS 3.0 memory flag KICK.
  151. V3.0:   Localized and RESIDENT  option  introduced.  PUBLIC is now always set,
  152.         CHIP, FAST and 24BITDMA are  set  according to the memory area's loca-
  153.         tion. The parameter format has been changed severely.
  154. V3.01:  Bug removed wich prevented AddMem from accepting memory above $100000.
  155.  
  156. ------------------------------------------------------------------------------
  157.  
  158.                                    //
  159.                        Thanks to \X/ Amiga for being the best computer ever !
  160.  
  161.